home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / timechk.zip / TIMECHEK.DOC < prev    next >
Text File  |  1988-10-24  |  4KB  |  115 lines
  1.  
  2.                         TIMECHEK.EXE v1.0
  3.  
  4.                                by
  5.  
  6.                  Mike Janke, Kendall BBS (1:135/4)
  7.  
  8.  
  9. TIMECHEK is 100% free of charge and carries absolutely no guarantee of
  10. any kind. If it breaks something, you get to keep both pieces.
  11.  
  12.  
  13.                           ACKNOWLEDGEMENTS
  14.  
  15. Thanks go to David Kerley (135/24) for the pascal knowledge he shared
  16. with this beginner pascal programmer (this is my first pascal program!).
  17.  
  18.  
  19.                           WHAT IT IS
  20.  
  21. Vernon Six called me one day and asked... "Do you know of a program
  22. that will downgrade/upgrade a user's security level and/or flags on a
  23. certain date?".  "Nah", says I, "But I can probably come up with
  24. something like that".
  25.  
  26. Sure enough, a few days later, TIMECHEK emerged.  I personally have no
  27. use for such a program, so testing has been difficult, but it seems to
  28. work as I (and Vern) wanted it to work.
  29.  
  30. This program would be used by someone that runs a subscription type of
  31. system (I guess).  A user pays X amount for so many months access and
  32. at the end of that time, TIMECHEK does whatever you say to his/her
  33. security level/access flags.  TIMECHEK does NOT delete (or flag as
  34. deleted) anyone... at least not intentionally!  You could let TIMECHEK
  35. set their access level to zero, and this is almost as good as deleting
  36. the user, but their record would not be purged during a USERPACK.
  37.  
  38. TIMECHEK modifies a user with a "target" date less than the current
  39. date. That means you don't have to run this every single day.  Once a
  40. week should be sufficient unless you are really picky about snagging
  41. that user exactly on the day his time has run out.
  42.  
  43. I haven't tried it with a full 500 line control file, but I can't
  44. imagine TIMECHEK taking more than 30 seconds to complete it's task
  45. even when running with a full load. So, a daily run shouldn't be that
  46. much trouble.
  47.  
  48.  
  49.  
  50.                       CHANGES SINCE Version 0.7
  51.  
  52. TIMECHEK is now in Turbo Pascal 4.0 instead of QuickBasic 4.0.  This
  53. has not greatly increased the program's speed, but it's a WHOLE LOT
  54. smaller now.  14k in Turbo Pascal vs. 48k in QuickBasic for the same
  55. program.
  56.  
  57. TIMECHEK will end with an errorlevel of 0 if all goes ok, otherwise,
  58. it'll drop out with an errorlevel of 1.  If you run this in your
  59. morning event batch file, you can trap this so you'll know of any
  60. problems.
  61.  
  62.  
  63.  
  64.                   HOW TO USE IT AND LIMITATIONS
  65.  
  66.  
  67. TIMECHECK is executed in your QuickBBS home directory and has two
  68. command line parameters; the name of the control file containing the
  69. info it needs and an optional switch to tell TIMECHEK to comment out
  70. (rather than remove) a users name from the control file.  See the
  71. enclosed TIMECHEK.CTL for a sample of what this control file looks
  72. like and its format.  If you use the filename TIMECHECK.CTL for your
  73. control filename, the command line would be...
  74.  
  75. TIMECHEK TIMECHEK.CTL
  76.  
  77. If you wanted TIMECHEK to comment out a Users name instead of just
  78. removing it from the control file, the command line would look like
  79. this...
  80.  
  81. TIMECHEK TIMECHEK.CTL -C
  82.  
  83. This is useful for those that don't mind maintaining the control file
  84. manually and would like to see a user name commented out and then know
  85. that they have in fact been downgraded by TIMECHEK.
  86.  
  87. The mention of 'maintaining' the control file brings up one of the
  88. limitations.  The control file can have 500 LINES MAXIMUM.  This means
  89. that if you don't fill the control file with comments, you have room
  90. for 500 user names for TIMECHEK to check up on.  This should be more
  91. than enough... no?
  92.  
  93. Other limitations?  Not too many.  You MUST supply the name of the
  94. control file THEN the optional -C switch if you want to use the
  95. switch.
  96.  
  97. Control file format is explained fully in the sample control flie.
  98.  
  99. TIMECHECK DOES MODIFY USERS.BBS.  Please check this program out
  100. thoroughly before unleashing it on your USERS.  I have tested it to
  101. the best of my ability, but again, since I don't run this type of
  102. system, I can't just go around downgrading my users just to test this
  103. over a long period of time.
  104.  
  105.  
  106. Enjoy.
  107.  
  108.  
  109.  
  110. Mike Janke  1:135/4
  111.  
  112. Voice (305) 271-0438
  113. BBS   (305) 271-2146
  114.  
  115.